home *** CD-ROM | disk | FTP | other *** search
/ MacGames Sampler / PHT MacGames Bundle.iso / MacGames Folder / Bolo / Brainwave 1.05 Folder / Brainwave Docs < prev   
Text File  |  1994-02-04  |  12KB  |  242 lines

  1. Brainwave v1.05
  2. Tom Gooding (tgooding@iastate.edu)
  3.  
  4. Brainwave is Bolo cyborg that improves your Bolo abilities.  Here's a list of its features.
  5.  
  6. Tank Controls
  7. ------------
  8. - Auto-Mapping
  9.         - Continuous local display and full-map display
  10.         - Topographical
  11.                     - Map shows terrain gradations, pillbox locations, and bases
  12.         - Tactical
  13.                     - Map shows pillboxes, bases, nearby tanks, and nearby builders
  14. - Radar
  15. - Auto-Aiming (Aligns tank to either the center or corner of a nearby object)
  16. - Stagger Mines
  17. - Clear Mines
  18.  
  19. Builder Controls
  20. ---------------
  21. - Automatic and manual road, bridge, and boat building (Determines nearby danger)
  22. - Automatic tree gathering (Determines nearby danger)
  23. - Can restrict speed when Builder is outside of tank
  24. - Can display time till new builder lands.
  25.  
  26. Miscellaneous
  27. ------------
  28. - Can transmit location to allies (upon request)
  29. - Can transmit current Brainwave version to all players
  30. - User Definable keys
  31. - Saves keys and menu selections in the Bolo Prefs file.
  32.  
  33. *** This version may not work a Quadra 840av ***
  34.  
  35. Requirements
  36. ------------
  37. Bolo 0.99.1+
  38. 020 processor or better
  39. 32-bit Quickdraw (Will work in B&W, however maps are almost unreadable)
  40. 64k available after Bolo is launched
  41.  
  42. WARNING
  43. --------
  44. This cyborg is not meant is a crutch for new players.  You should be able to play Bolo just fine without this brain.
  45.  
  46. Setup
  47. -----
  48. Drop Brainwave into the Bolo "Brains" folder.  Launch Bolo and enable Brainwave, under the "Tank Controls" menu.
  49.  
  50. * If the auto-mapping functions are disabled, increase the memory allocation by about 100k.  Or reduce the Monitors setting to 16 colors.
  51.  
  52. Automatic Functions
  53. ------------------
  54. Brainwave can control builder functions:  harvest trees, build roads, bridges, and boats automatically.  Brainwave will only send out the builder if not in danger.  The danger must also be gone for 2 seconds.  Pressing the 'Forget Danger' key will ignore any danger and send the builder no matter what's out there --- You may lose your builder.
  55.  
  56. If your tank is hidden, the builder will only gather trees from behind it.  This reduces the chance of your location being revealed.  
  57.  
  58. If your tank is visible, the builder will only take trees adjacent to your tank, excluding trees within 45° of your current gun position.
  59.  
  60. Brainwave will automatically build roads and bridges if you are approaching or on craters, rubble, swamp, water.  Brainwave will save 1 tree (2 trees if building roads) for emergency purposes.
  61.  
  62. The 'Efficient Bridges' option will try to conserve trees.  It will build a bridge when it HAS too, as opposed to building nearly every square.  This option is great if you are limited to resources.  With this option checked, Brainwave can go about 27 to 29 squares over water without sinking (assuming a full speed and load of trees).  Without, it can go between 19-26 squares without sinking.
  63.  
  64. Brainwave can automatically build a boat if you are completely surrounded by water.
  65.  
  66. * Lag may mess up the bridge building procedure (because Bolo won't called Brainwave during that period) and you may lose a few shells and/or it might build a boat.
  67.  
  68. You can also deploy the builder to build a boat on a body of water that's in the direction of your tank's current facing.  For instance if you are approaching water (i.e. 5 squares away) the builder will be sent ahead of your tank to build the boat.  Just continue in your present direction.  The builder can also be deployed to build a road or bridge in the direction of the tank's facing.
  69.  
  70. Information Window
  71. ------------------
  72. The information window is the black box with the red lettering.  It tells you information on your location, builder, and surrounding area.  On the right side of the window is a local map (It can be either the Tactical map or the Topographical, as determined by the menu selection).
  73.  
  74. If your builder gets somehow gets killed (I advise against this ever happening), the far left side tells you the directions from your tank to your builders landing location.  It will also approximate the time to landing, based upon the current game speed.
  75.  
  76. Mapping Functions
  77. ----------------
  78. As your tank moves across the terrain, Brainwave updates two maps, the Topographical and the Tactical.  They can be displayed several ways:
  79. 1) Menu selection
  80. 2) By a keypress
  81. 3) Viewing the local area in the information window
  82.  
  83. Topographical Map
  84. ----------------
  85. The topographical map shows the terrain, your location, and any pills and/or bases.  
  86. All pillboxes appear red and all bases appear yellow, your tank appears white.  No other objects appear on this map.
  87.  
  88. Tactical Map
  89. ------------
  90. The Tactical map shows all enemy objects as red and all friendly objects as green.  An object can be a tank, base, pillbox, builder.  Water is also shown for reference.
  91.  
  92. If any pillbox is known to be 33% damaged or more, then it will flash on this map.  The status of your pillboxes is known at all times.
  93.  
  94. If a base has changed alignment, it will also flash for a short period of time.
  95.  
  96. Hide Bases will not show any of the bases on the tactical map or in the radar (although they will still be updated)
  97.  
  98. * Pillboxes that have been picked up by the enemy are not removed from the map.  They change color and stay in their original location until information to the contrary is revealed.  When in doubt, check the main Bolo window.  Bolo, as of version 0.99.2, does not pass any information about each pill (i.e. is it being carried by someone).  Only the pills that are currently nearby or owned by you are known.
  99.  
  100. Radar
  101. -----
  102. The radar window will show objects that are visible to the tank.  It is always 100% accurate.  Otherwise it is the same as the Tactical map.
  103.  
  104. The 'Rotating Radar' option will rotate the objects such that the objects you are facing appear north.  Similar to Spectre's radar.
  105.  
  106. Shapes on Tactical Map and Radar
  107. ------------------------------
  108.  
  109. Base             Tank               Pillbox               Builder
  110.  •••                •                       • 
  111.  •  •              •••                   •••                      •
  112.  •••              •  •                     •
  113.  
  114. Allies appear green
  115. Enemies appear red
  116. Neutral objects appear gray
  117. Your tank and builder appears white
  118.  
  119. * Shapes of the tactical map may get temporarily distorted because the map is not constantly being redrawn.
  120.  
  121. Stagger Mining
  122. -------------
  123. This function will not lay any mines if there is a mine adjacent to the tank.  This prevents the chain reaction effect and makes fortifying your bases easier.
  124.  
  125. * This function can't work well around lag.  Dropping mines from the tank is not accurate under laggish conditions.  This may get fixed in future Bolo versions.
  126.  
  127. Clear Mines
  128. ----------
  129. Holding down the key will clear mines.  If "Clear All Mines" is selected then the tank will destroy all mines within range.  Otherwise it will just destroy mines within 45° of the gun position.
  130.  
  131. * Brainwave cannot destroy any mines that have been placed on the map but still visible to the user via the "No hidden mines" option.  Bolo does not tell Brains where these mines are even though they are visible on the screen, as of v0.99.2.  They do however become visible when nearby.
  132.  
  133. Auto-Aimming
  134. -------------
  135. Holding down the auto-aimming keys will align the tank to the object that your tank is  "aimed" at.  The information window tells you what you are currently aiming at and its distance.  These functions will try to 'perfect' the aiming.
  136.  
  137. "Align Tank" will aim your tank to the center of the object
  138. "Offset Tank" will aim your tank to the second farthest corner of the object (Useful when used in conjunction with some wall tricks)
  139.  
  140. 'Align Tank'     'Offset Tank'       
  141.  
  142.      • • •               • • ◊
  143.      • ◊ •               • • •
  144.      • • •               • • •
  145.  
  146.  
  147.               Δ                          Δ
  148.  
  149. The "Don't target allies" will ignore all allied objects when aiming the tank.
  150. The "Don't target bases" will ignore all bases when aiming the tank.
  151.  
  152. * If you are aiming at a builder, Brainwave will also adjust the range.
  153.  
  154. Communication
  155. --------------
  156. If Brainwave receives a "/who" command from any player, Brainwave will respond with its name and version number.
  157.  
  158. If Brainwave receives a "/where" or "/status" command from an ally, Brainwave will send your current location or other information.  It will only send the information to your allies.  The information sent can be modified, see below.
  159.  
  160. TroubleShooting
  161. ---------------
  162. Brainwave may be too slow to work on certain computers, causing play to be choppy.  I've tried to speed things up, but graphics speed can be really slow.  Here are a few things you can try in order to speed things up:
  163. -) Turn off large maps and radar (if currently being displayed)
  164. -) Quit background applications (if any)
  165. -) Switch to 16 colors
  166. -) Turn off the Info bar
  167. -) Turn off Auto-Mapping
  168. -) Turn off various builder functions
  169.  
  170. * If Auto-Mapping is your problem, it will be fixed when the map is mapped.  To 'ease the lag', you could turn off Auto-Mapping and flip it on at different spots on the map. (mosaic mapping, perhaps?)
  171.  
  172. If Brainwave causes Bolo or Finder to crash, make sure your memory was sufficient.  If it was then email me, be as specific as possible.  As far as I know it is very stable.
  173.  
  174. * I don't know if Brainwave will work with System 6
  175.  
  176.  
  177. Modifying Brainwave
  178. -------------------
  179. You can modify the format of the '/where' and '/status' lines to send to information you want.  You need ResEdit to modify the STR# resources named "/where" or "/status".
  180. The following text fragments will insert the appropriate information into the line.
  181. 'XXX'..............X location
  182. 'YYY'..............Y location
  183. 'NAME'..........Your current name
  184. 'DIR'..............Your current tank direction
  185. 'SPEED'........Current speed
  186. 'AMMO'.........Amount of shells
  187. 'ARMOR'.......Strength of armor
  188. 'TREES'........Amount of trees
  189. 'PILLS'.........Amount of pills carried
  190. 'BUILDER'....Current status of your builder
  191.  
  192. Other '/blah' commands:
  193. '/ping'................Outputs 'Pong'
  194. '/motto'............Outputs the text in the STR# resource named "/motto"  This is intented
  195.                       as fun.
  196.  
  197. * DO NOT distribute a modified version of Brainwave
  198.  
  199. Future Plans
  200. -----------
  201. - Incorporating Pillbox views into map data
  202. - Expand information transfer options
  203. - Keep track of enemy builder's landing times/locations
  204. - Hooks for allied helper brains to pass information and commands (i.e. "/protect me")
  205. - Create helper brain (Would be a separate brain)
  206. - Increase speed
  207. - Warning sounds
  208. - Any other ideas???
  209.  
  210. Versions
  211. --------
  212. 1.0 - Released January 24, 1994.
  213. 1.1 - Released February 4, 1994.
  214.     - Key presses are now ignored when the message window is foremost.
  215.         - Window positions are now saved
  216.     - Keyboard functions can now be deactivated to avoid 'key confusion'
  217.     - Defaults can now be reset
  218.     - No Key, Swap and Restore buttons added to Set Keys window
  219.  
  220. Acknowledgements
  221. -----------------
  222. I would like to thank the following people for extensively beta-testing Brainwave:
  223. David Clancy
  224. Jonas Cooper
  225. Joseph Goodman
  226. Edward Gray
  227. Chris Howard
  228. David Josselyn
  229. Gersham Meharg
  230. Herb Petschauer
  231. Cory L. Scott
  232. Ned Watson
  233. -----------------
  234. Please respond with any comments or suggestions for future versions to:
  235.  
  236. Tom Gooding
  237. tgooding@iastate.edu
  238. Iowa State University
  239.  
  240. BTW - If you encounter a bug, please be somewhat descriptive.  Most of this code has been tested under single player or AppleTalk modes against Indies.  I have not had a lot of time to test it under lag conditions.
  241.  
  242.